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Foreword 

This Technical Specification (TS) has been produced by the ETSI 3' Generation Partnership Project (3GPP). 

The present document may refer to technical specifications or reports using their 3GPP identities, UMTS identities or 
GSM identities. These should be interpreted as being references to the corresponding ETSI deliverables. 

The cross reference between GSM, UMTS, 3GPP and ETSI identities can be found under www.etsi.org/kev . 
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Foreword 



rd , 



This Technical Specification (TS) has been produced by the 3 Generation Partnership Project (3GPP). 

The present document is part of the 32.300-series covering the 3''' Generation Partnership Project: Technical 
Specification Group Services and System Aspects; Telecommunication Management; Generic IRP Management, as 
identified below: 

32.311: "Requirements"; 

32.312: "Information Service". 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 



The Itf-N interface is built up by a number of Integration Reference Points (IRPs) and a related Name Convention, 
which realise the functional capabilities over this interface. The basic structure of the IRPs is defined in 
3GPP TS 32.101 [1] and 3GPP TS 32.102 [2]. 

All IRPs support a set of generic features. Those features allow to retrieve IRP profile and IRP supported versions. The 
present document contains the specification of those generic features. 
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Scope 



The purpose of the present document is to define a common service supported by all IRPs. This document is the 
"Information Service" part. It defines, for the purpose of supporting the common service, the information observable 
and controlled by management system's client and it also specifies the semantics of the interactions used to carry this 
information. 

With this common service supported by all IRPs, an IRPManager can retrieve the profile of operations and notifications 
supported by a given IRP supported by an IRP Agent. An IRPManager can also retrieve the different versions supported 
by an IRP. 
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References 



The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[1] 3GPP TS 32.101: "3G Telecom Management principles and high level requirements". 

[2] 3GPP TS 32.102: "3G Telecom Management Architecture". 

[3] 3GPP TS 32.301: "Notification IRP: Requirements". 

[4] 3GPP TS 32.622: " Generic Network Resources: NRM". 

[5] 3GPP TS 32.31 1: "Generic IRP Management: Requirements". 
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Definitions and abbreviations 



3.1 



Definitions 



For the purposes of the present document, the following terms and definitions apply. For terms and definitions not 
found here, please refer to 3GPP TS 32.101 [1], 3GPP TS 32.102 [2] and 3GPP TS 32.301-1 [3]. 

IRPAgent: see 3GPP TS 32.102 [2] 

IRPManager: see 3GPP TS 32.102 [2] 

IRP document version number string (or 'TRP Version"): see 3GPP TS 32.31 1 [5] 

IRP: see 3GPP TS 32.102 [2] 

Qualifiers: the meaning of qualifiers for operations, parameters and information attributes (whether they are 
Mandatory(M)/ Conditional(C)/ Optional(O)) defined in the present (Information Service) document is provided in 
3GPP TS 32.102 [2]. Moreover, qualifiers of information attributes, when those information attributes are re-used in 
other IRP ISs, obey to the following rule: Mandatory and Conditional qualifiers of information attributes shall always 
be the same in other IRPs ISs, Optional qualifiers of information attributes may be set to either Optional or Mandatory 
in the other IRP ISs 



3.2 



Abbreviations 



For the purposes of the present document, the following abbreviations apply: 



CM 

DN 

EM 

IOC 

IRP 

IS 

ITU-T 

NE 

NM 

NR 

NRM 

OMG 

SS 

UML 



Configuration Management 

Distinguished Name 

Element Manager 

Information Object Class 

Integration Reference Point 

Information Service 

International Telecommunication Union, Telecommunication Standardisation Sector 

Network Element 

Network Manager 

Network Resource 

Network Resource Model 

Object Management Group 

Solution Set 

Unified Modelling Language (OMG) 
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4 System overview 

4.1 System context 

Figure 1 and Figure 2 identify System contexts for this service in terms of implementations called IRP Agent and 
IRPManager. 

"IRPManager" depicts a process that interacts with IRP Agent for the purpose of receiving network Notifications via this 
IRP. IRP Agent detects network events. IRP Agent sends IRPManagers notifications carrying the events. Examples of 
IRPManagers can be a process running supporting network Notification logging device or supporting network 
Notification viewing devices (such as a local craft terminal) or a process running within a Network Manager (NM) as 
shown in Figure 1 and Figure 2. IRP Agent implements and supports this IRP. IRP Agent can run within one Element 
Manager (EM) with one or more NEs (see Figure 1) or run within one NE (see Figure 2). In the former case, the 
interfaces (represented by a thick dotted line) between the EM and the NEs are not subject of this IRP. Whether EM and 
NE share the same hardware system is not relevant to this IRP either. By observing the interaction across the IRP, one 
cannot deduce if EM and NE are integrated in a single system or if they run in separate systems. 




Figure 1 : System Context A 
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Figure 2: System Context B 
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5 Information Object Classes 

5.1 Information entities imported and local labels 



Label reference 


Local label 


32.622 [4], information object class, GenericIRP 


GenericIRP 



5.2 Class Diagram 



5.2.1 Attributes and relationships 



This sub-clause depicts the set of lOCs that encapsulate information relevant for this service. This sub-clause provides 
the overview of all information object classes in UML. Subsequent sub-clauses provides more detailed specification of 
various aspects of these information object classes. 



«lnformationObjectClass» 
ManagedGenericIRP 
#iRPVersions 

# operationNamePro files 

# operationParameterProfiles 

# notificationNameProfiles 

# notificationParameterProfiles 



5.2.2 Inineritance 

This clause depicts the inheritance relationships that exists between information object classes. 











«lnformationObjectClass» 
GenericIRP 












\ 






«lnformationObjectClass» 
ManagedGenericIRP 
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5.3 Information object classes definition 
5.3.1 ManagedGenericIRP 



5.3.1.1 



Definition 



This information object represents a generic IRP which supports generic management capabiUties. It inherits from IOC 
GenericIRP. 



5.3.1.2 



Attributes 



Attribute name 


Support Qualifier 


IRPVersion 


M 


operationNameProf ile 





operationParameterProf ile 





notif icationNameProf ile 





notif icationParameterProf ile 






5.4 Information relationships definition 

None 



5.5 



Information attributes definition 



This clause defines the semantics of the Attributes used in Information Object Classes. 
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5.5.1 Definitions and legal values 



Attribute Name 


Definition 


Legal Values 


irpVersion 


This attribute contains a set of 

IRPVersions. The set contains at least 

one element. 


Any value of the 

following format : 

"32.xyz Va.b" 


operationNameProfile 


This attribute contains a set of 

elements. 

The n-th element of this set contains 

the set of operation names supported 

for the IRPVersion identified in the n- 

th element of irpVersion attribute 




notificationNameProfile 


This attribute contains a set of 

elements. 

The n-th element of this set contains 

the set of notification names 

supported for the IRPVersion 

identified in the n-th element of 

irpVersion attribute 




operationParameterProfile 


This attribute contains a set of 

elements. 

The n-th element of this set contains 

the set of set of notification 

parameters supported by the 

operations identified in the n-th 

element of operationNameProfile 

attribute. 

The set of operation parameters are 

placed in the set in the same order as 

the order followed by the operation 

names in their set 




notificationParameterProfile 


This attribute contains a set of 

elements. 

The n-th element of this set contains 

the set of set of notification 

parameters supported by the 

notifications identified in the n-th 

element of notificationNameProfile 

attribute. 

The set of notification parameters are 

placed in the set in the same order as 

the order followed by the notification 

names in their set 





Interface Definition 



6.1 Class diagram representing interfaces 













: 


«lnterface» 
GenericlRPVersionOperations 






+ getlRPVersionO 




1 


^^"~~^^ 








«lnformationObjectClass» 
ManagedGenericIRP 








^^^^ 




«lnterface» 
GenericlRPProfileOperations 




1 










+ getOperationProfileO 
+ getNotificationProfileQ 










1 
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6.2 



Generic rules 



• rule 1 : each operation with at least one input parameter supports a pre-condition valid_input_parameter which 
indicates that all input parameters shall be valid with regards to their information type. Additionally, each such 
operation supports an exception operation_failed_invalid_input_parameter which is raised when pre-condition 
valid_input_parameter is false. The exception has the same entry and exit state. 

• rule 2: Each operation with at least one optional input parameter supports a set of pre-conditions 
supported_optional_input_parameter_xxx where "xxx" is the name of the optional input parameter and the pre- 
condition indicates that the operation supports the named optional input parameter. Additionally, each such 
operation supports an exception operation_failed_unsupported_optional_input_parameter_xxx which is raised 
when (a) the pre-condition supported_optional_input_parameter_xxx is false and (b) the named optional input 
parameter is carrying information. The exception has the same entry and exit state. 

• rule 3: each operation shall support a generic exception operation_failed_internal_problem which is raised when 
an internal problem occurs and that the operation cannot be completed. The exception has the same entry and 
exit state. 



6.3 genericlRPVersionOperations Interface 

6.3.1 Operation getlRPVersion (M) 



6.3.1.1 



Definition 



IRPManager wishes to find out the IRP SS versions supported by an IRP. The IRP shall respond with a set of supported 
IRP SS version(s). The list of returned IRP versions is such that the IRPManager can use any of these versions without 
having to specify an IRPVersion to the IRP Agent. 



6.3.1.2 

None 



Input parameters 



6.3.1.3 



Output parameters 



Parameter Name 


Quali 
fier 


Matching Information 


Comment 


versionNumberSet 


M 


ManagedGenericIRP.iRPVersi 
on 


It indicates one or more SS version 
numbers supported by the IRP. 


status 


M 


ENUM (Operation succeeded. 
Operation failed) 


If operation_failed_internal_problem 
status = OperationFailed. 



6.3.1.4 

None specific 

6.3.1.5 

None specific 

6.3.1.6 

None specific 



Pre-condition 



Post-condition 



Exceptions 
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6.4 genericlRPProfileOperations Interface 
6.4.1 Operation getOperationProfile (O) 



6.4.1.1 



Definition 



IRPManager invokes this operation to query the detailed profile of an IRP (supported operations and supported 
parameters) for a specific supported version. The notification profile will provide details about notifications that are 
specifically defined by this IRP. 



6.4.1.2 



Input parameters 



Parameter Name 


Quali 
fier 


Information Type 


Comment 


irpVersion 


M 


Element of 
ManagedGenericIRP.iRP Version 


It contains a version number. 



6.4.1 .3 Output parameters 



Parameter Name 


Quali 
fier 


Matching Information 


Comment 


operationNameProf ile 


M 


Elements of 


If this parameter contains no 






ManagedGenericIRP.operationNa 


information, it implies that the 






meProfile coiTesponding to the 


IRP does not support any 






irpVersion pai'ameter 


operation. 


operationParameterPr 


M 


Elements of 




of ile 




ManagedGenericIRP.operationPar 
ameterProfile corresponding to 
the irpVersion parameter 




status 


M 


ENUM (Operation succeeded, 


If 






Operation failed) 


operation_failed_invalid_version 
status = OperationFailed. 



6.4.1.4 Pre-condition 

validlRPVersion 



Assertion Name 


Definition 


vahdIRPVersion 


"the irpVersion input parameter identifies a supported version contained in attribute 
iRPVersion of ManagedGenericIRP" 



6.4.1.5 Post-condition 

None specific. 

6.4.1.6 Exceptions 



Name 


Definition 


Operation_failed_invalid_ 


Condition: validlRPVersion is false. 
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version 



Returned Information: The output parameter status. 
Exit state: Entry State 



6.4.2 Operation getNotificationProfile (O) 



6.4.2.1 



Definition 



IRPManager invokes this operation to query the detailed notification profile of an IRP (supported notifications and 
supported parameters) for a specific supported version. The notification profile will provide details about notifications 
that are specifically defined by this IRP. For example, if this IRP is notification IRP R4, then getNotificationProfile will 
not return any information since no notification are defined in notification IRP R4. 



6.4.2.2 



Input parameters 



Parameter Name 


Quali 
fier 


Information Type 


Comment 


irpVersion 


M 


Element of 
ManagedGenericIRP.iRPVersion 


It contains a version number. 



6.4.2.3 Output parameters 



Parameter Name 


Quali 
fier 


Matching Information 


Comment 


notif icationNameProf 


M 


Element of 


If this parameter contains no 


ile 




ManagedGenericIRP. notification 


information, it implies that the 






NameProfile corresponding to the 


IRP does not support any 






irpVersion parameter 


notification. 


notif icationParamete 


M 


Element of 




rProf ile 




ManagedGenericIRP. notification 
ParameterProfile coiTesponding to 
the irpVersion parameter 




status 


M 


ENUM (Operation succeeded, 


If 






Operation failed) 


operation_failed_invalid_version 
status = OperationFailed. 



6.4.2.4 Pre-condition 

validlRPVersion. 



Assertion Name 


Definition 


vaHdIRPVersion 


"the irpVersion input parameter identifies a supported version contained in attribute 
iRPVersion of ManagedGenericIRP" 



6.4.2.5 Post-condition 

None specific. 
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6.4.2.6 Exceptions 



Name 


Definition 


Operation_failed_invalid_ 
version 


Condition: validlRPVersion is false. 

Returned Information: The output parameter status. 

Exit state: Entry State 
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